Operator BaseRgbCamera

Operator Library: Hardware Platform

オペレーターは、Camera LinkのBASE RGB構成カメラからの画像データをVisualAppletsに転送します。 Camera Link規格のすべてのRGB BASE構成がサポートされています。

このオペレーターは、CameraPortタイプのプールのリソースを排他的に使用します。 フレームグラバーのCamera LinkポートA( 0 )またはCamera LinkポートB( 1 )を選択できます。 同じリソースインデックスは、1つのアプレットにつき1回のみ使用できます。

microEnable 5 ironman VD8-PoCL:mE5 VD8-PoCL(ironman)では、ポートAのみがすべてのカメラ機能(CC信号やシリアルインターフェースなど)を提供します。 mE5 VD8-PoCL(ironman)のポートBは、CC信号もシリアルインターフェースも提供しません。 それにもかかわらず、事前にカメラがプログラミングされていれば、フリーランモードでカメラを動作させることができます。 ポートBに関するこれらの制限は、mE5 VD8-PoCL(ironman)にのみ当てはまるものであり、このオペレーターを使用するその他のフレームグラバーモデル(LightBridge、marathonなど)には当てはまりません。

[重要] 「タップ」の定義

本書で使用されるワンタップとは、任意のBit Widthを持つ、デコードされた1つのカラーコンポーネントを意味します。

CameraLink Specification Version 2.1では、ワンタップはすべてのカラーコンポーネントを含む1つのカラーピクセルとして定義されていることに注意してください。

次の表は、VisualAppletsの表記法とCamera Link仕様書バージョン2.1の間のマッピングを示しています:

VA表記 CameraLink表記
Tap3x8 ................ 8-bit RGB Medium 1 tap

表 57. VA表記とCL仕様バージョン2.1のマッピング


次の図は、このモード(Tap3x8bit)でのピクセルマッピングを示しています。

ハードウェアプラットフォームで使用可能
mE5 marathon VCLx
mE5 marathon VCL
LightBridge VCL
mE5 VD8-PoCL (ironman)

I/O Property

Property 値
オペレータータイプ M
Output Link O、画像データ出力

サポートされているリンクフォーマット

Link Parameter Output Link O
Bit Width [3,63]1
Arithmetic unsigned
Parallelism 任意、パラメータの説明を参照
Kernel Columns 1
Kernel Rows 1
Img Protocol {VALT_IMAGE2D,VALT_LINE1D}
Color Format VAF_COLOR
Color Flavor FL_RGB
Max. Img Width 任意
Max. Img Height 任意

1

RGBタプルのため、Bit Widthは3の倍数である必要があります。

パラメータBitWidthには、カメラから実際に送信されるBit Widthよりも大きい値または小さい値を設定できます。

カメラから実際に送信されるBit Widthよりも小さい値がパラメータに設定されている場合、 ピクセルコンポーネントの最下位ビット(LSB)が切り捨てられます。 ピクセルコンポーネントごとの最上位ビット(MSB)のみがVisualAppletsに転送されます。

パラメーターに、カメラから実際に送信されるビット幅よりも大きな値が設定されている場合、 元のピクセルコンポーネントは出力コンポーネントのMSB位置に配置されます。LSBはゼロで埋められます。

どちらの場合も、相対的な明るさは変わりません。つまり、白いピクセルは白のままで、暗いピクセルは暗いままになります。

パラメーター

DvalMode
タイプ 動的書き込みパラメータ
Default DVAL_Enabled
範囲 {DVAL_Enabled, DVAL_Disabled}

DVALを使用して有効なピクセルをマスクするか、それとも無視するかを指定します。 DVALが無視される場合、有効なピクセルはLVALおよびFVALのステータスに従って選択されます。

FvalMode
タイプ dynamic/static write parameter
Default CameraLinkStandard
範囲 {CameraLinkStandard, IgnoreFval}
  • CameraLinkStandard

    オペレーターはカメラからのフレーム有効(FVAL)信号を待機します。 この場合、オペレーターはFVALサイズに従ってフレームを出力します。

  • IgnoreFval

    この設定を使用すると、オペレーターはカメラからのFVAL信号をすべて無視します。 すべての入力ラインが使用され、無限の高さを持つ単一の画像にマージされます。

    [注] Output Image Protocol VALT_IMAGE2Dでのみ利用可能です

    このパラメータは、出力が画像プロトコルVALT_IMAGE2Dに設定されている場合にのみ利用可能です。 VALT_LINE1Dが選択されている場合、パラメータは無効になり、FVALはどちらにしても無視されます。

    [Warning] VisualApplets Link Rules Violation

    カメラオペレーターが無限の高さのフレームを出力する場合、link propertiesで定義されたMax. Img Heightを超える可能性があります。 これにより、VisualAppletsのリンク規則違反が発生します。 有効な高さを必ず使用してください。 SplitImageオペレーターを使用して画像の高さを制限し、無限の画像を複数のチャンクに分割してください。

このパラメータの目的は、エリアスキャンカメラとラインスキャンカメラを同じアプレット内で動的に使用できるようにすることです。

BaseMode
タイプ 動的書き込みパラメータ
Default Tap3x8bit
範囲 {Tap3x8bit}

このパラメータは、BASEコンフィギュレーションモードを指定します。

CameraStatus
タイプ 動的リードパラメータ
Default
範囲

LightBridge/marathon:[0;2^8-1]

mE5 VD8 ironman:[0;2^4-1]

bit[0]:PCLK利用可能

bit[1]:FVAL現在値

bit[2]:LVAL現在値

bit[3]:DVAL現在値

bit[4-7]:予約済み(LightBridgeおよびmarathonのみ)

CameraLinkCoreReset
タイプ 動的書き込みパラメータ
Default 0
範囲 [0; 1]

サポートに関する問題用に予約されています。

PixelClock
タイプ 動的リードパラメータ
Default 0
範囲 [0; 85] MHz

MHz単位のカメラチャンネルのピクセルクロックレート。

MinimalParallelism
タイプ static read parameter
Default 1
範囲 [1; 1024]

出力リンクOがデータの損失なしにカメラの最大帯域幅を転送できるようにするための最小の Parallelism。 この値は、現在選択されているデザインクロック周波数によって異なります。 周波数が高くなるほど、Parallelism の値を小さくすることができます。